home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / macdec3.zip / README.TXT < prev    next >
Text File  |  1991-12-15  |  71KB  |  1,239 lines

  1. Author:  Dale L. Fenimore                                     15 December 1991
  2.  
  3. Disclaimer:  These Wordperfect 5.1 macros are released in an AS IS condition. 
  4. No warranty is provided that they will work for you or be what you want or
  5. need.  Use them at your own risk.  I wrote these macros to make things easy
  6. for myself; if they do the same for you then fine - I accept no responsibility
  7. for any document on which any of these macros were used and for which you may
  8. claim damage as a result of said use.
  9.  
  10. Disclaimer #2:  No Government time, equipment, or resources were involved in
  11. the development of this macro suite.  However, the Government has benefited
  12. from their use.
  13.  
  14. Updates.  These macros are periodically updated as I add to, improve, or
  15. enhance them.  Improvements are always in the works. To date, several of these
  16. macros have been completely replaced or substantially improved/modified over
  17. their original state.
  18.  
  19. Recommended Machine.  The faster the machine the better the performance.  I
  20. have run these macros on an 8MHz AT and, though SLOW, they worked fine. 
  21. However, nothing less than 12MHz is recommended (and even they may be a tad
  22. slow...). However, if you don't know any better (aren't addicted to speed like
  23. some of us) most of these macros should prove more than adequate.  Some will
  24. seem just TOO SLOW on a slow machine to be useful.
  25.  
  26. Recommended WordPerfect Interim Release Version.  31 May 91 or later. The
  27. reason for this is that ALTF (FILES) and ALTX (EXIT) rely on a feature added
  28. to interim release dated 31 May 91. This feature allows easy detection of the
  29. use of Long Document Names.  If you aren't using Long Document Names and you
  30. have interim release 30 Dec 90 or earlier, you can, if you can do some macro
  31. programming, route the macro around the long document name test.  Your best
  32. bet, though, is to upgrade to the latest interim release of Wordperfect for
  33. DOS.  For registered users this means about $15. Contact the WordPerfect
  34. Orders Desk at (800) 321-4566.
  35.  
  36. What's Provided.  
  37. I.  The following macros are provided. Some are found within a WordPerfect
  38. keyboard definition file (WPK). Included below is a brief description of each
  39. macro.
  40.     Notes:
  41.     a)  ENV.WPM needs the file called ENVELOPE.REF placed in your WP51
  42.     directory before it works correctly (also, these files are separate and
  43.     not in the keyboard definition file).  Additionally, you'll need to
  44.     modify ENVELOPE.REF for your particular printer.
  45.     b) ALTH, the Help macro is too large for inclusion into the WPK.
  46. II. The following macros are provided:                                                        MNEMONIC BASIS
  47.  MACRO                 DESCRIPTION                      FOR THE MACRO
  48.  
  49. ALTA         Macro to place text anywhere on a page     (ADVANCE)
  50. ALTB         Block document segments for special action (BLOCK)
  51. ALTC         Drop Caps                                  (CAPITAL)
  52. ALTD         Provides Menu Access to drives & dirs      (DIR)
  53. ALTF         Save/Get file w/o prompts w/current name   (FILE)
  54. ALTH         Help information on these macros           (HELP)
  55. ALTL         Long/Short Doc Name Save/List              (LIST)
  56. ALTN         Choose predefined Special Characters       (NEW Characters)
  57. ALTP         Print menu                                 (PRINT)
  58. ALTV         Preview Document                           (VIEW)
  59. ALTX         Exit WP51 w & w/o Save. Needs ALTF.WPM     (EXIT)
  60. CTRL A       Save File as ASCII                         (ASCII)
  61. CTRL D       Format Date for Inclusion in document      (DATE)
  62. CTRL O       Character over Character                   (OVER)
  63. CRTL S       Superscript over Subscript                 (SUB/SUPERSCRIPT)
  64. CTRL Enh Right/Left
  65.              Places cursor at end of current/word-on-left, respectively
  66.              
  67. ALT Enh Right/Left
  68.              Places cursor at next/previous column or table cell, respectively
  69. Shf Enh Right/Left
  70.              Places cursor at next/previous sentence, respectively
  71. ALT-         Used for paragraph numbering/renumbering   --------
  72. ALT[         Transpose character right                  --------
  73. ALT]         Transpose character left                   --------
  74. CTRL Del     Deletes word or block of text              --------
  75. CTRL PgDn    Retrieve a Named Memory Variable           --------
  76. ENV          Create Addresses for envelopes, Printing reqr's ALTP
  77. ENVELOPE.REF      Sample Reference file for ENV.WPM
  78. LTRHD        Create headings for Military letterhead (Easily modified for
  79.              other types of letterhead)
  80.              (CTRL L)
  81. MEMO         Create a heading for a Memo letter (CTRL M)
  82. FN           Used by macros to provide/modify file names and/or paths
  83. DP           Provides a common drive/path menu for use by other macros
  84.  
  85. NOTES:
  86. 1. Macros provided in the WPK, but not mentioned here are considered
  87. temporary. 
  88. 2. These macros are powerful augmentations to WordPerfect's native
  89. abilities.  However, on slow machines, these macros will likewise seem slow.
  90. On faster machines though, they'll just whiz by.  Recommended machines are
  91. those with clock speeds of 12 MHz or faster.
  92. 3. These macros have a tendency of being constantly revised, updated, and/or
  93. improved. Macro Descriptions:
  94. ALT A     Essentially the same as the Shf F8, (O)ther, (A)dvance menu
  95.           selection.  However, this macro requires far fewer keystrokes to
  96.           access.  Additionally, being menu driven makes it easier to use.
  97.  
  98. ALT B     This is an extremely feature filled, highly useful macro.
  99.           a. Combines the features of MOVE (CTRL F4) with a few other
  100.           enhancements.  Allows the user to block the following types of
  101.           text:  character(s), word(s), sentence, paragraph, page or a
  102.           specified block.  It then allows the addition of various
  103.           enhancements (font size or attribute),  super/subscripts, quotes,
  104.           delete the block (a sort of enhancement...), upper/lowercase, or to
  105.           keep it blocked.
  106.           b. Text in the move buffer may also be retrieved.  Duplicates and
  107.           improves upon WordPerfect's block retrieve feature (CTRL F4 4 1,
  108.           also known as CTRL F4 RB)
  109.           c. You can also move, copy or delete the defined block of text. 
  110.           Note:  Text deleted with this macro is placed in the Move block
  111.           temporary storage area and not in the delete holding area. 
  112.           Retrieve it using ALTR or the retrieve block option in menu 1.  
  113.           d. Lowercasing a sentence will capitalize the first letter of it's
  114.           first word.
  115.           e. Lowercasing a PARAGRAPH will recapitalize the first letter of
  116.           every sentence's first word within the paragraph
  117.           f. If you've already blocked some text when you run this macro it
  118.           will automatically go to the Menu 2. This menu provides for
  119.           operation upon blocks of text
  120.           g. Two true quotes is placed in the document by hitting ALT-B O Q
  121.           (access the BLOCKing macro, ■O■ for Options menu and ■Q■ for
  122.           Quotes).  If the character at the cursor is a space the two quote
  123.           characters are entered and the cursor placed between them
  124.           otherwise, the character at the cursor is quoted.  However, if
  125.           there is a blocked region, that region is quoted.
  126.           h. Menu 3. Essentially the same as hitting Ctrl F8 (A)ppearance or
  127.           (S)ize and then the appropriate menu item.  What this macro does is
  128.           put these options in the same menu.  This macro is sensitive to
  129.           active blocks.  If a menu choice is made without text being
  130.           blocked, the character on which the cursor rests will take on the
  131.           attribute chosen from the menu.  However, if a block is active, all
  132.           text within that block takes on the attribute of the chosen menu
  133.           item.  NOTE:  Normally part the (S)ize option of CTRL F8 menu,
  134.           Super/Subscripts are not within this section of the macro. 
  135.           Sub/Superscripts exits at the previous level of this macro
  136.           i. If Menu 2 is chosen from Menu 1 (with no active block), the
  137.           chosen option acts as if a single character was chosen; exception:
  138.           Move and Copy which will not work without an active block of text
  139.           chosen.
  140.           j. You may uppercase the first character of a word or the first
  141.           word of each sentence without lowercasing the sentence or paragraph
  142.           first.
  143.           k. Spell check a defined block or the current word.
  144.           ■Limitation■:  1) Character blocks only recognize the following as
  145.           valid characters:  0-9, a-z and A-Z Use the Wordperfect BLOCK
  146.           feature (ALT F4, or, on extended keyboards F12) for other
  147.           characters. 2) When moving or copying text to the end of a document
  148.           ensure that at least two spaces exist at the location to which you
  149.           are moving/copying the text.  If you don't, the moved/copied text
  150.           won't appear automatically.  The problem lies with WordPerfect
  151.           somehow and I haven't figured a way around it yet.  If the text
  152.           doesn't appear as expected hit the retrieve macro (ALT-R) to obtain
  153.           it.  3)  Block copies and moves may not work as expected when those
  154.           copies/moves cover more than one column (block or block protect
  155.           columns) or more than one table cell.
  156.  
  157. ALT C     Adds a Drop Cap to your paragraph.  Allows you to specify the
  158.           desired character or, if a character is blocked will convert that
  159.           character to a Drop Cap.  You may also specify a new size for the
  160.           base font.  Requires scalable font capability.  DON'T USE WITHIN
  161.           TABLES!
  162.  
  163. ALT D     An extension to the LIST (F5) key in that this macro is
  164.           customizable to include the subdirectories or drives used often. 
  165.           This means they are only one or two keystrokes away rather than
  166.           many. You may want to customize it for your particular subdirectory
  167.           structure.  (ALT D).
  168.           
  169.           NOTES:
  170.           1.  The WordPerfect files directory is assumed to be called WPDOC.
  171.           You may change it though by changing the contents of the variable
  172.           DOCDIR. This variable is located at the beginning of the macro for
  173.           easy modification, if necessary.
  174.           2. The WordPerfect subdirectory is assumed to be called WP51.  You
  175.           may change the contents of the variable called WPDIR to reflect
  176.           your WordPerfect subdirectory.
  177.           3.  This macro is designed for use with LONG or SHORT file names. 
  178.           However, unless you have a Jun 90 or later WordPerfect 5.1 interim
  179.           release the use of long filenames will not correctly be detected
  180.           and the macro may not work correctly.
  181.  
  182. ALT F     Saves a file or retrieves a file depending upon the status of the
  183.           document. There is also an option to provide a document summary or
  184.           print the file (or a portion of it).  The primary purpose for this
  185.           file though, are the features described below.
  186.           Save File.  If the current document window has a file in it (or has
  187.           been modified in any way) this macro displays a menu which has a
  188.           number of options for saving the current file. The macro detects
  189.           files with no names and prompts the user to supply one. 
  190.           Retrieve File.  If the current document is BLANK the macro
  191.           retrieves information from a special file concerning the last
  192.           file(s) edited.  This information was obtained during an exit from
  193.           WordPerfect using the Exit macro (ALTX)). This information is then
  194.           displayed to the user.  Depending upon the information displayed,
  195.           one or more files may be retrieved.  During the process of
  196.           retrieving the file(s) the cursor relocated to the last edited
  197.           position.  LIMITATIONS: 1) If page renumbering was used then the
  198.           cursor may not return to the exact same spot.  However, the macro
  199.           attempts to place the cursor at an ■equivalent■ spot of matching
  200.           the page, line and position on the line locations. 2) You'll need
  201.           Jun 90 or later WordPerfect interim release if you use long
  202.           document names.
  203.  
  204.           NOTE: If you are upgrading from a version of these macros which is
  205.           prior to late October 91 you'll need to run the CONVERT macro to
  206.           auto-retrieve your files (as described above).
  207.  
  208. ALT H     Provides a brief description of all macros provided. Completely
  209.           menu driven.
  210.  
  211. ALT L     Provides an easy method of switching between Long and Short (DOS)
  212.           Document names when Saving and/or listing files.  All legal options
  213.           are provided:
  214.           a. Long names when saving: long names or short names in display
  215.           listing
  216.           b. Short names when saving: long names or short names in display
  217.           listing.
  218.  
  219. ALT N     There are a number of chosen characters in many different
  220.           categories. Nominally organized by category choose the character(s)
  221.           by number. If your printer doesn't recognize the character chosen
  222.           WP51 sends it as a graphic (provided your printer is not a daisy
  223.           wheel printer).  LIMITATION:  There are three symbols which use
  224.           user defined character specifications (Character set 12).  They are
  225.           #'s 54, 59, and 61.  They may or may not print.  If they do print,
  226.           there is no telling how they'll print unless you use ITC Zapf
  227.           Dingbats (I'm currently using the Postscript cartridge for a
  228.           LaserJet II).  Redefine as necessary.  NOTE:  alphabetic characters
  229.           entered with numbers will show up as bad options but will not
  230.           interfere with any other chosen options.
  231.  
  232. ALT P     Print a page, specified pages, the entire document, initialize the
  233.           printer, or go to the WordPerfect print menu (SHF F7).  During
  234.           print operation the macro identifies whether a page or the document
  235.           is being printed. This macro also reports the page number on which
  236.           the cursor rests.  Just prior to exiting, the macro reports that it
  237.           is exiting.  This is a helpful feature for slower machines which
  238.           may take some time before being able to actually exit.
  239.  
  240. ALT V     The same as Shf F7, (V)iew
  241.  
  242. ALT X■    Exit from WP or the document.  Sensitive to whether the current
  243.           document has been modified.  Calls ALTF for file save operations. 
  244.           Detects blank files and automatically exits from either WP or the
  245.           document when called.  If called, and printing is on-going. this
  246.           macro provides the option of continuing with the exit or returning
  247.           to the document to continue printing.  Additionally, on an exit
  248.           from WordPerfect this macro saves the information on the current
  249.           file(s) for later automatic retrieval. This information is used by
  250.           ALTF for automatic file retrieval.
  251.  
  252. CTRL A    Stores a file as ASCII text.  Takes current filename, removes
  253.           extension, and supplies a specific extension for the ASCII save --
  254.           as supplied that extension is "TXT".  User may redefine extension
  255.           by changing variable contents at beginning of macro.  User may
  256.           store file with a different file name and/or path by supplying the
  257.           appropriate information.  The default ASCII file extension may also
  258.           be overridden to force storage of file with a specific filename and
  259.           extension.  Existing files with same name are detected.  Files
  260.           without names when macro is executed are detected.  Original
  261.           filename is restored at the completion of an ASCII store.  A file
  262.           with same name when the ASCII extension is added is detected and
  263.           taken care of during an ASCII save (ASCII saves will not be
  264.           overwritten by a WP51 format document inadvertently)
  265.  
  266. CTRL D    Provides options to chose a date format for inserting into a
  267.           document.  These formats include Standard (mm dd, yy), Military (dd
  268.           mm yy), and Contracting (yy mm dd).  Additionally, the name of the
  269.           month may be a three letter abbreviation or fully written out.  The
  270.           year may be the last two digits (e.g. 91) or the entire year (e.g.
  271.           1991).
  272.  
  273. CTRL S    Places a superscripted value over a subscripted value.  Example: 
  274.           Eab.  The macro places a space directly after the last value so the
  275.           user can continue typing.  Also, the macro is independent of font
  276.           size and uses no position sensitive codes.  Spacing adjustment is
  277.           automatically calculated for proper placement of text.  CAVEAT:  If
  278.           the size of text is changed AFTER this character set is created you
  279.           may need to make proper adjustment for the superscripted value (or
  280.           redo the equation). However, a variance of two points, larger or
  281.           smaller, does not significantly alter the appearance of the printed
  282.           result.  If the typeface is  changed (say from Times Roman to
  283.           Century Schoolbook) chances are the equation WILL need to be
  284.           redone.
  285.  
  286. ALT -     Provides for paragraph numbering. Executing this macro and hitting
  287.           ■A■ or ■ENTER■ will create an automatic paragraph numbering based
  288.           upon the number of tabs/indents the cursor is from the left margin. 
  289.           Hitting a number between 1 and 8 will chose a specific level of
  290.           paragraph numbering. The Option ■N■ will reset the new paragraph
  291.           number to 1. The ■S■, setup, option will send you to the paragraph
  292.           numbering setup menu provided by WordPerfect.
  293.  
  294. ALT [     Takes the character at the cursor and transposes it left by one
  295.           position. Characters include formatting characters as well. See ALT
  296.           ].
  297.  
  298. ALT ]     Takes the character at the cursor and transposes it right by one
  299.           position.  Characters include formatting characters as well.  If
  300.           the character at the cursor is one which is not paired (as in
  301.           {BOLD}{bold} it may be transposed.  If the character is paired, the
  302.           cursor is moved until a transposable character is found- it is then
  303.           transposed.
  304.  
  305. ALT Enh Right Arrow
  306.           Right/LeftPlaces cursor at next column or table cell
  307.  
  308. ALT Enh Left Arrow
  309.           Places cursor at previous column or table cell
  310.  
  311. CRTL Enh Left Arrow
  312.           Places cursor at the end of the word to the left of the current
  313.           word.  Moves past all formatting code until cursor reaches the
  314.           actual text
  315.  
  316. CTRL Enh Right Arrow
  317.           Places cursor at the end of the current word.  Moves through the
  318.           word until it reaches the end of the word (or formatting code
  319.           whichever comes first)
  320.  
  321. Shift Enh Right Arrow
  322.           Move cursor to the beginning of the next sentence
  323.  
  324. Shift Enh Left Arrow
  325.           Move cursor to the beginning of the previous sentence
  326.  
  327. CTRL PgDn Retrieve the contents of a memory variable. (RXMEM) To use, the
  328.           memory variable must exist (otherwise there's nothing to retrieve
  329.           and you get an error message).  To assign a memory variable from
  330.           the keyboard, block the text desired (up to 127 characters) and hit
  331.           Ctrl PageUp.  At the variable prompt, provide a name and hit enter. 
  332.           Or, hit Ctrl PageUp, and at the variable prompt, provide a name and
  333.           hit enter.  Then, at the value prompt, enter the desired text.  To
  334.           retrieve the contents of this variable hit Ctrl Pageup and provide
  335.           the name of that variable.  The retrieved text is placed directly
  336.           into your document.  This macro is assigned to the PgDn key of
  337.           extended keyboards.
  338.  
  339. CTRL Del  Delete a block of text or, if block isn't active, the current word
  340.  
  341. ENV       Creates the text to place on an envelope which is then placed on a
  342.           page defined by ENVELOPE.REF.  Menu options allow editing your
  343.           info, viewing the document, exiting to the document, deleting the
  344.           current page or adding another record.  You may want to rename this
  345.           to ENV. 
  346.  
  347. FN        This file is used by ALTF and ALTX to handle the manipulation of a
  348.           filename and it's path. This macro takes a file's name and path and
  349.           allows you to replace, insert and or add characters to the file
  350.           specification. It then returns the result to the calling macro.  It
  351.           has NO direct user utility.
  352.  
  353. CTRL M    (MEMO) The macro will prompt for the type of Memorandum it is (i.e.
  354.           Memo for...).  It also prompts for the subject of the memo and from
  355.           whom.  The macro then places the Memo text on the first line flush
  356.           left, the Date is placed flush right and then a graphic line is
  357.           inserted under which is placed the subject and from.  All tabs and
  358.           margins are automatically setup.
  359.  
  360. CTRL L    (LTRHD) Prompts for REPLY TO ATTN OF, SUBJECT, and TO for placement
  361.           on Military preprinted letterhead.  Variables are created such that
  362.           it is easy to change the placement of these inputs to compensate
  363.           for actual placement of these prompts between different batches of
  364.           letterhead.  Note: this letterhead is usually ¼" narrower than
  365.           normal 8.5"x11" paper.  This means that if you measure a one inch
  366.           left margin (about two spaces to the right of the semi-colon) you
  367.           will actually need about a 1.17" left margin (for example).  All
  368.           document initialization's are placed at the top of the macro. 
  369.           Useful tool for non-military as well - modify as appropriate to
  370.           your organizational letterhead (or your own). Replaced Macros.  These are macros which, as others matured, had their
  371.           abilities taken over by another (i.e. were superseded).
  372.  
  373. REMOVED
  374. .
  375. ALT S  Search (forward/reverse), Spell, subscript/superscript.  Everything
  376.        but search transferred to the Blocking macro (ALTB). The search
  377.        capability provided no real value added over the native WP search
  378.        capabilities.
  379.  
  380. REPLACED by ALT B.  This macro now has all of the functionality of these
  381. macros, including ease of use, such that they are now longer necessary as
  382. standalone macros:
  383.  
  384. ALT C  Upper or lower cases a character or, if the block is active,
  385.        upper/lower case all text within the block
  386. ALT E  Enhance Text:  Size and Appearance
  387. ALT I  Italicize a character or a block of characters
  388. ALT L  Lowercase a character or a block of characters
  389. ALT Q  True quotes of a block of text or if no active block, placement of the
  390.        cursor between two true quotes
  391. ALT R  Retrieve text from WordPerfect buffer
  392. ALT S  The Spell Check option of this macro was revised, extended and
  393.        improved by inclusion into ALTB
  394. ALT S  Subscript and Superscript capability transferred into ALTB.
  395. ALT U  Uppercase a character or a block of characters
  396. ALT W  1.  Blocks a word. This macro is punctuation sensitive.
  397.        2.  Transposes a word forward or reverse of its present position
  398.  
  399. Notes.
  400. ■  If ALTX recognizes that a document was modified it calls the SAVE macro,
  401. ALTF, to save it.  If you execute ALTX and ALTF resides in a keyboard
  402. definition file an error is generated because WordPerfect can't find ALTF. 
  403. The problem is that a WP51 macro cannot call (and therefore execute) another
  404. macro which exists only in a keyboard definition file.  Macros (within a
  405. keyboard definition file or standalone) can only call standalone macros.
  406. ■  The HP Laser Jet Series II appears to be off by 0.2c (too much) when
  407. advancing.  The letterhead macro is the one place I've noticed this ■problem.■
  408. Measurements are made to place the text at specific places used by the
  409. military pre-printed letterhead and the measurement for the left margin may
  410. need appropriate adjustments for your printer. These macros are currently
  411. setup for the Apple LaserWriter IINTX (or HP Series II with a Postscript
  412. Cartridge). Macro Dependencies:
  413.  
  414. (1) ALT F - ALT P, ALT X, ALTD, DP, FN, ASCII(2)ALT X - ALT F, DP, FN
  415. (3) ALT [ - TR                           (4)  Env - ALT P
  416. (5) ALT D - DP, FN                       (6)  ALT L - ALT D, ALT F
  417. (7) ASCII - DP, FN, ALT F
  418.  
  419. NOTES:
  420. 1. All WordPerfect (DOS) standalone macro files have WPM as their extension.
  421. Other macro files are found in WordPerfect keyboard file (which have WPK
  422. extensions).
  423. 2. Any macro which is depended upon by another macro for certain features must
  424. remain as a standalone macro.
  425. 3. ALTF relies on information supplied by ALTX (when WP51 is exited) to retrieve
  426. the last file(s) edited.
  427. 4. Macros which call other macros CANNOT call a macro in the same or different
  428. keyboard definition file.  This means, if such an event happens, and the called
  429. macro is not found in the macro directory (a .WPM file) it is reported as missing
  430. or non-existent.
  431. 5. Neither FN nor DP have any user capability.  They provide features for the
  432. macros which call them.
  433. 6. The DOS filename for ALT], the TRANSPOSE RIGHT macro is TR.  DOS won't accept
  434. the "]" character as part of a filename so ALT] isn't a viable name. TR is the
  435. standalone version of the ALT] macro which is in the WPK file.
  436. 7. This macro, ASCII, was assigned to the CTRL A key. ASCII is no longer
  437. embedded within the keyboard definition file.
  438.  
  439. Improvement History (by macro):
  440. ALTA
  441. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  442.         slower machines. (Version 3.7e)
  443.  
  444. ALTB
  445. 21 Sep1 Printing of any block is now allowed now.  This includes a character,
  446.         word, or sentence (previously disallowed).  This macro allows printing
  447.         a block at it's current location.  WordPerfect will get the line correct
  448.         but if you printed the blocked region which exists in the middle of a
  449.         paragraph, it'll print beginning at the left margin.  This macro has it
  450.         start printing at the line position reported by WordPerfect.  NOTE
  451.         (important):  WordPerfect does microjustification.  Therefore, if you
  452.         use other than left justification in your documents the true location
  453.         on the page may not accurately reported (for some reason) by
  454.         WordPerfect.  Also, the blocked region will have it's own
  455.         microjustification independent of the text surrounding it so, a sentence
  456.         in the middle of the paragraph may print differently from what you might
  457.         expect (less tight kerning for instance).  With this in mind, happy
  458.         printing! The macro also identifies what type of block you are printing
  459.         (character, word, etc). (Version 3.33)
  460.  
  461. 22 Sep1 The two methods I've used to test for end/begin of document don't always
  462.         work correctly between different interim releases of WP. This might
  463.         evidence itself by a tilde (~) appearing in your document.  I started
  464.         seeing this with interim release 5/31/91 when blocking sentences at the
  465.         end of a document. I had to rewrite the sentence blocking section to
  466.         avoid this problem.  If no sentence is recognized an error message is
  467.         generated before returning to menu 1.  This is possible if there is
  468.         nothing to block or, you are at the bottom of the document and
  469.         formatting codes exist after the last sentence but before the end of the
  470.         document.
  471.  
  472.         I also reworked all four menus slightly.  These menus are now one line
  473.         higher than before. Menu 3 is now wrapped onto the lowest line instead
  474.         of going to the end of first line. In multiple mode the only line which
  475.         gets rewritten now is the lowest line.  This line identifies those
  476.         enhancements being added to the document.  This is especially beneficial
  477.         to those with slower systems since the entire menu needn't be rewritten
  478.         now. If you attempt to go to menu 4 without first blocking something the
  479.         error message is displayed in the lowest line.
  480.         An entire screen refresh is no longer performed between menus as was a
  481.         previous practice.
  482.  
  483.         Formerly, during an index, if you made an index entry for the primary
  484.         index but didn't want a subindex you got one anyway. This is fixed. 
  485.         Now, to accept a subindex you either hit the "=" key (and hit enter to
  486.         accept the default subindex) or type in another subindex.  Hitting the
  487.         enter key without an entry will default to NO subindex.  (Version 3.34)
  488.  
  489. 23 Sep1 Fixed a problem with a sentence being blocked such that the blocking
  490.         would end with the cursor on one or more lines below the block start but
  491.         at the left margin.  This would cause a "No Sentence Found" error (which
  492.         was bogus). (Version 3.34a)
  493.  
  494. 23 Sep1 Abbreviated the menus to allow quicker screen writing on slower
  495.         machines.  Improved menu 3 to write only the necessary changes when
  496.         going between the Multiple and non-multiple modes.  This substantially
  497.         improves the speed at which the menu modes switches. (Version 3.34b)
  498.  
  499. 23 Sep1 Menu 4 now includes options to go directly to Menus 1, 2 or 3.  Hitting
  500.         the enter key in any of the menus takes you to the previous menu level. 
  501.         One minor difference is that if menu 4 was called from menu 2, hitting
  502.         the enter key in menu 4 will return you to menu 2.  Returning to menu
  503.         1 from any of the other menus will still turn off the active blocking
  504.         but will also return the cursor to the beginning of that block rather
  505.         than leaving it at the end of the block as was the case. (Version 3.34c)
  506.  
  507. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  508.         slower machines. (Version 3.34d)
  509.  
  510. 13 Oct1 A minor bug caused menu 3 to display when a sentence was blocked. 
  511.         However, menu 2's options were active (not menu 3's).  This no longer
  512.         occurs. Another fix involved words which contained soft hyphens (the one
  513.         you get directly from the keyboard).  WordPerfect would have now problem
  514.         blocking the entire word containing hyphens.  However, the macro would
  515.         block a word up to the hphen.  This was fixed to perform similarly to
  516.         the way WordPerfect's word block performs. (Version 3.34e)
  517.  
  518. 11 Dec1 Minor change to Quotes.  Added checking for a hard return at the current
  519.         cursor location. Now, if a space OR a hard return is found, the quotes
  520.         are placed next to each other and the cursor moved between them. 
  521.         Without this check for the hard return I found that the close quote
  522.         would often end up on the next line (after the hard return). (Version
  523.         3.34f)
  524.  
  525. 11 Dec1 Minor change made to Multiple Enhancements.  Added a prompt to show
  526.         which options being added. As each option is added to the document it
  527.         is stripped from the displayed list options chosen. This display is
  528.         particularly useful for slower systems and provides feedback that
  529.         something is actually being done.  Fast machines'll probably see a quick
  530.         blip of info...  (Version 3.34g)
  531.  
  532. ALTC
  533. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  534.         slower machines. (Version 2.60a)
  535.  
  536. ALTD
  537. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  538.         slower machines. (Version 3.70o)
  539.  
  540. 2 Oct1  If an error occurs the WordPerfect is reset to used the default document
  541.         directory to be on the save side of things. (Version 3.70p)
  542.  
  543. 10 Nov1 Removed directory menu information and placed it into a separate file,
  544.         DIRPATH.  This file is then used by all other macros needing access to
  545.         that same menu information (ALTF, for instance). Options are now case
  546.         sensitive (they are no longer converted to uppercase from lowercase). 
  547.         (Version 3.8)
  548.  
  549. 12 Nov1 Made a few changes to make it easier to make changes to drives and
  550.         directories. All directory and drive information is now in DP (formerly
  551.         called DIRPATH). (Version 3.8a)
  552.  
  553. 13 Nov1 Fixed the macro so that it works more closely to WordPerfect's
  554.         operation. So, if you chose to do a directory on drive A (with ALTD) and
  555.         later you hit LIST (F5) you'll get a default directory of drive A. 
  556.         Previous to this you'd get a default directory listing of your WP51
  557.         Document directory.  An error handling routine was reactivated. After
  558.         displaying its menu the error routine will return to the directory menu.
  559.         (Version 3.8b)
  560.  
  561. 14 Nov1 Added a routine to assist, in certain cases, accessing drives.  It does
  562.         this by reminding WP what the default drive is.  To perform ONLY this
  563.         reset, execute ALTD and then exit the macro. (Version 3.8c)
  564.  
  565. 17 Nov1 Let's say you chose the OTHER option.  Then, you decided that's not what
  566.         you wanted to do and hit CANCEL. The 2nd menu line which identified the
  567.         current path wasn't restored.  This was fixed. (Version 3.8d)
  568.  
  569. 21 Nov1 Variables were being cleared which were needed for proper saving of the
  570.         autoretrieve file.  This was a holdover from the time when this was a
  571.         self-contained file.  These variables no longer need to be cleared at
  572.         the end of this macro any longer. (Version 3.8d1)
  573.  
  574. 12 Dec1 Moved an identifier variable to earlier in the macro to allow proper
  575.         menu display under certain circumstances. (Version 3.8d2)
  576.  
  577. ALTF
  578. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  579.         slower machines. (Version 3.35a)
  580.  
  581. 29 Sep1 Substantially enhanced AutoRetrieve capability.  Macro now retrieves one
  582.         or more files depending on the information stored in the data file. 
  583.         Senses status of files currently loaded and adjusts the menu
  584.         accordingly.  For instance, if information on two files is stored in the
  585.         data file and one file is already being edited then you may retrieve one
  586.         files indicated and not both.  Macro added the option of NOSAVE to the
  587.         menu line.  Normally this option isn't needed.  However, it might be
  588.         needed when this macro is called by the EXIT macro (ALT X). (Version
  589.         3.4)
  590.  
  591. 29 Sep1 It used to be that you had to provide a name for files without names.
  592.         This has changed. The user is now asked if he/she wants to provide a
  593.         name.  If the answer is yes the macro proceeds as usual.  If the answer
  594.         is no then the macro is exited.  This is not normally an issue unless
  595.         the EXIT Macro (ALT X) has called this macro. (version 3.40a)
  596.  
  597. 30 Sep1 A bug in the program wouldn't allow the retrieve menu to display under
  598.         some conditions.  This was fixed.  The macro was also modified so that
  599.         when called by the EXIT macro (ALT X) with a blank file the user may
  600.         exit the macro (by using the cancel key and thereby the exit operation),
  601.         provide the file with a name, or exit the file. Prior to this an exit
  602.         from an unnamed file using the ALT X macro wasn't directly possible. 
  603.         (Version 3.40b)
  604.  
  605. 1 Oct1  Fixed a problem which occurred when making a choice not provided - the
  606.         macro would end up exiting after a short while. Made some changes to
  607.         allow proper operation of the EXIT macro (ALT X) when the ALL and both
  608.         document options called this macro and the file had no name. What
  609.         happens is that a return code is returned based upon an option made in
  610.         this macro.  Part of this change was the modification of the menu used
  611.         for unnamed files to include a CANCEL option.  (Version 3.41)
  612.  
  613. 2 Oct1  Made some programmatic changes to improve user control under certain
  614.         circumstances (primarily in providing answers to prompts.  Some prompts
  615.         looked only for a "Y" answer with all other responses, rightly or
  616.         wrongly, all grouped together. These changes stop that practice.) 
  617.         (Version 3.41a)
  618.  
  619. 4 Oct1  Macro was doing a name check of the file being saved via a system call
  620.         rather than a variable call.  This was providing improper results at
  621.         times. (Version 3.41b)
  622.  
  623. 6 Oct1  Gave a more flexible rename capability.  When a file is given a name a
  624.         path may or may not be specified. Once the name is supplied return is
  625.         made to the main menu. From here, you may store to any drive or
  626.         subdirectory listed with a simple keystroke.  For drives, the name you
  627.         supplied is used along with the drive specified.  For subdirectories,
  628.         these take direct control and store immediately to that subdirectory. 
  629.         If you've renamed a file and you've specified the root directory and you
  630.         want to store that file to a subdirectory, forget it with this version
  631.         unless you store the file first.  This will be fixed in a future
  632.         version.  The Rename menu for use with long document names has been
  633.         slightly modified to be less confusing and more direct.  (Version 3.51)
  634.  
  635. 7 Oct1  Improved auto-recall error handling.  If one or the other file doesn't
  636.         exist the one which does exist is retrieved into document #1 and the
  637.         user left in document #1. If neither exist nothing is retrieved!
  638.         (Version 3.51a)
  639.  
  640. 7 Oct1  Fixed the root directory problem identified by the 6th of Oct change. 
  641.         Choosing a root directory as part of the name of a file is no longer a
  642.         problem.  Now, the new name is parsed and separated from the path
  643.         regardless of length.  (Version 3.51b)
  644.  
  645. 13 Oct1 Changed the routine which gives/changes filenames to a subroutine
  646.         module. Portions of this macro which rely on this subroutines' functions
  647.         must now CALL (as opposed to GO to) it. Portions of this macro which
  648.         merely went to this routine were modified to reflect that change.
  649.         (Version 3.52)
  650.  
  651. 27 Oct1 Modified the macro to rely on a routine which specifically handles the
  652.         full path specification of a file during a file save.  See FN for a
  653.         description of the full functionality. (Version 3.6)
  654.  
  655. 3 Nov1  Added OTHER option to the menu.  This allows the user to specify a
  656.         destination not identified by the menu when saving a file. (Version
  657.         3.6a)
  658.  
  659. 3 Nov1  Provided a multiple save option.  This allows more than one save
  660.         location during a save operation.  NOTES: (1) Only provided drives
  661.         and/or subdirectories are valid options (OTHER isn't provided at this
  662.         time). (2) A RESET to the original subdirectory or drive is performed
  663.         after all save operations (including multiple operations and all single
  664.         drive operations, excluding single subdirectory saves). (Version 3.7)
  665.  
  666. 6 Nov1  a) Fixed a tendency the macro had with saving the file to the original
  667.         path three times during a multiple save (the original path is the path
  668.         the file had when the macro was first run).  b) Changed the "save to a
  669.         drive path" option to act like a save to a subdirectory path (i.e., that
  670.         option BECOMES the path).  This doesn't happen during multiple saves
  671.         though.  After multiple saves the path is reset to the original path.
  672.         c) Long document names weren't being saved during a file save (i.e.,
  673.         during Rename or providing a nameless file a name). Fixed this problem. 
  674.         (Version 3.71)
  675.  
  676. 7 Nov1  Added several options: SUMMARY and PRINT. Also added additional
  677.         identification for the OTHER option for clarification of its use.
  678.         SUMMARY puts the user into the document summary screen -- ALTF
  679.         terminates. The PRINT option executes and passes control to the PRINT
  680.         macro (ALTP) -- ALTF terminates. Minor changes were made to the SAVE
  681.         menu. (Version 3.72)
  682.  
  683. 10 Oct1 Took the menu of options out of this macro and placed it in a macro file
  684.         called "DIRPATH".  This macro file is reponsible for all menu options. 
  685.         The advantage of this is that this file is also used by all files
  686.         needing access to this same menu (ALTD, for instance). Options are now
  687.         case sensitive (they are no longer converted to uppercase from
  688.         lowercase). (Version 3.73)
  689.  
  690. 12 Nov1 Made some changes to make it easier to add/delete/modify directories
  691.         and/or drives.  All drive and/or directory information is now contained
  692.         in DP (formerly DIRPATH).  DP is called to initialize some variables
  693.         used by ALTF. (Version 3.73a)
  694.  
  695. 14 Nov1 Added a routine to assist, in certain cases, accessing drives.  It does
  696.         this by reminding WP what the default drive is.  To perform ONLY this
  697.         reset, execute ALTF and then exit the macro. (Version 3.73b)
  698.  
  699. 17 Nov1 Let's say you chose the OTHER option.  Then, you decided that's not what
  700.         you wanted to do and hit CANCEL. The 2nd menu line which identified the
  701.         current path specification wasn't restored.  This was fixed. (Version
  702.         3.73c)
  703.  
  704. 19 Nov1 Suppose you decided to rename a file. If you get all the way to the full
  705.         path specification and then  decide you don't want to rename the file
  706.         after all. You hit CANCEL twice (to get back to the main FILE menu) only
  707.         to discover that the path specification had TWO copies of the path to
  708.         the file - no longer. (Version 3.73d)
  709.  
  710. 21 Nov1 The document identification line in the menu was changed so that a file
  711.         with no name was a tad more unambiguously identified.  Variables
  712.         initialization is now performed prior to checking for a blank document.
  713.         (Version 3.74)
  714.  
  715. 22 Nov1 Minor menu modifications. (Version 3.74a)
  716.  
  717. 23 Nov1 In the rename menu, where you were providing the new filename, the
  718.         current filename (and/or path) wasn't being displayed. (Version 3.74b)
  719.  
  720. 24 Nov1 If a file with the same name already exists as the newly named or
  721.         renamed file a message to that effect is created.  You may accept the
  722.         new name (and overwrite the "original" file) or provide another name.
  723.         (Version 3.75)
  724.  
  725. 24 Nov1 The capability provided with the previous revision has been extended for
  726.         the EXIT macro (ALTX). When a file is renamed at the EXIT menu of the
  727.         EXIT macro the existence of a file of the same name is checked prior to
  728.         the actual file save. (Version 3.75a)
  729.  
  730. 26 Nov1 When CANCEL was hit before reaching the filename there was no longer any
  731.         way (really) to give the file a name without going completely out of the
  732.         macro and reentering it. This is no longer the case. (Version 3.75b)
  733.  
  734. 26 Nov1 Added an option to save file as ASCII.  This option transfers control
  735.         over to the ASCII macro. Also removed some code which caused spurious
  736.         "FILE EXIST" operation (when it shouldn't do so). (Version 3.76)
  737.  
  738. 27 Nov1 Modified to display the EXIT menu header if ALTX (exit document option)
  739.         calls this macro. (Version 3.76a)
  740.  
  741. 1 Dec1  Initial version capable of retrieving up to two documents out of a
  742.         maximum total of 4 of the most recently edited documents.  User must
  743.         identify the document(s) to retrieve, in any order, up to 2 in quantity.
  744.         If both document screens are empty the user may request 2 documents,
  745.         otherwise only 1 may be retrieved. (Version 4.00)
  746.  
  747. 5 Dec1  Revised the retrieve algorithm for better efficiency.  Order of document
  748.         request is order of retrieval (in other words, the numbers 31 will
  749.         retrieve document #3 to document screen 1 and document #1 to document
  750.         screen #2).  Added the ability to remove 1 or more files from the
  751.         autoretrieve data file.  Removing all files causes macro termination
  752.         after informing that there are no files to retrieve.  (Version 4.01)
  753.  
  754. 10 Dec1 If Multiple Save was called immediately after a file rename, the process
  755.         of returning to the "original path and file name" would result in a
  756.         reset of the file to its original and not the newly provided name.
  757.         (Version 4.01a)
  758.  
  759. 11 Dec1 If you don't want to choose from the AutoRetrieve file selections hit
  760.         the EXIT key and you'll enter the DIRECTORY macro (ALTD). (Version
  761.         4.01b)
  762.  
  763. 12 Dec1 Made a few minor changes so that when ASCII is called just after a file
  764.         rename (and before it has actually been saved) it knows that the current
  765.         file does indeed have a name. (Version 4.02)
  766.  
  767. 13 Dec1 Made some minor changes to support a call from ALTX during a document
  768.         exit. This change basically involved moving document exit responsibility
  769.         from ALTF to ALTX if EXIT was chosen at the ALTF menu requesting the
  770.         user to provide a file name (for a file without a name). (Version 4.02a)
  771.  
  772. 13 Dec1 Made some minor changes to allow the normal ALTF message line above the
  773.         main menu when called by ALTX during a document exit. (Version 4.02b)
  774.  
  775. ALTH
  776. 21 Sep1 Updated for changes to ALTN. (Version 2.03c)
  777.  
  778. 11 Nov1 Broke the macro into four (4) sections. The first section is the master
  779.         menu (ALT H). The other sections are for each type of macro key: ALT,
  780.         CTRL, and Shift.  These macros are named ALTKEY, CTRLKEY, and SHFKEY
  781.         respectively.  Operation of the macro is essentially the same. (Version
  782.         2.1)
  783.  
  784. 14 Dec1 Finally placed a less terse menu in the main help menu.  Added the space
  785.         bar to the options which'll quit the help macro.
  786.  
  787. ALTL
  788. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  789.         slower machines. (Version 2.00c)
  790.  
  791. ALTN
  792. 21 Sep1 Added a new category: Technical.  Added several characters too. Angstrom
  793.         (Å) was placed in Technical and degree (■) was moved there. The square
  794.         root sign and hi-bar were added to Math.  These two together make a
  795.         decent looking square root sign (√■). ) (Version 2.92)
  796.  
  797. 23 Sep1 Sometimes, the macro wouldn't accept the first character.  A guess is
  798.         that the bad option flag was set when the macro was run resulting in a
  799.         bogus error indication.  This flag is now reset upon running the macro. 
  800.         Hopefully this fixes the problem. (Version 2.91a)
  801.  
  802. ALTP
  803. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  804.         slower machines. (Version 2.41a)
  805.  
  806. 2 Oct1  Made a message change to the menu for allowing the printing of odd or
  807.         even pages from a range of user supplied page numbers.  Also, provided
  808.         an extension to the "print from current page to end" and the "print from
  809.         start to current page" so that only odd or even pages are printed.  The
  810.         user only selects "e" or "o" with a "+" or "-" to do so.  At this time
  811.         the options "oe", "eo", "+-" and "-+" will print ALL pages (it's
  812.         equivalent to Print Entire Document).  (Version 2.50)
  813.  
  814. 3 Oct1  Redid the main menu.  Renamed "Specific Page(s)" to "Multiple Page(s)". 
  815.         Renamed "Document" to "File" Option.  Rearranged the menu to read "This
  816.         Page/File". Cleaned up a few minor bugs. (Version 2.50a)
  817.  
  818. ALTV    No change since 12 Jan 91
  819.  
  820. ALTX
  821. 21 Sep1 If not at the main editing screen (for example, while in a page preview
  822.         or directory list), hitting ALT X will exit to it.  (Version 2.13a)
  823.  
  824. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  825.         slower machines. (Version 2.13b)
  826.  
  827. 29 Sep1 Major Revision.  Macro now stores information on both documents so one
  828.         or the other may be retrieved by the FILE macro (ALT F).  Information
  829.         is obtained on only non-empty files.  Information on all available files
  830.         is displayed to the user, to rename or accept, before an actual file
  831.         save is completed.  During a file rename the user may give the file a
  832.         new name to store the file by or tell the macro not to save the file. 
  833.         Accept will save the files, store the file information (path, name,
  834.         cursor position), and exit WordPerfect. The data file has a different
  835.         structure than previous versions.  A macro (Convert.wpm ) has been
  836.         provided to convert from the old to the new structure. (Version 3.00)
  837.  
  838. 30 Sep1 Exit ALL documents is now provided.  This procedure is functionally the
  839.         same as the WordPerfect exit except that the user remains in WordPerfect
  840.         after all documents are exited. Also, through changes to the FILE macro
  841.         (ALT F), the current unnamed document may be exited under control of the
  842.         macro.  Prior to this such an action wasn't directly possible. (Version
  843.         3.00a)
  844.  
  845. 1 Oct1  Fixed a problem in which an improper call to the FILE macro (ALT F)
  846.         disabled proper macro execution. Fixed some minor problems with making
  847.         choices which weren't on the menu. Fixed a problem with the option ALL.
  848.         When there were files with no names both files might or might not be
  849.         exited. Either that or there'd be an error of some sort. Modifications
  850.         to the FILE macro (ALT F) and the EXIT (ALT X) macro together now allow
  851.         proper operation on unnamed files. Now the files aren't arbitrarily
  852.         exited when the options ALL, document or DOCUMENT are chosen. (Version
  853.         3.01)
  854.  
  855. 4 Oct1  Gave direct access to available files (modified or unmodified) for
  856.         renaming (a shortcut to the renaming a file). The saving of a renamed
  857.         file didn't work correctly in the previous version but has been fixed
  858.         in this one. If a file has been given a new name it is saved under that
  859.         new name (whether or not the original was modified) along with the
  860.         appropriate cursor location information.  Note: in this version it is
  861.         important for the user to supply the file's full path as part of its new
  862.         name.  This is particularly important for later automatic retrieval of
  863.         the file.  If you use C: instead of C:\, for instance, the macro will
  864.         look in the current directory instead of the root directory.  If the
  865.         current directory is not the root directory the file won't be found...
  866.         Also, disabled the use of the ENTER key at the RENAME ACCEPT menu. The
  867.         user is now forced to respond appropriately (it was nice to respond with
  868.         the ENTER key to save the files and exit WordPerfect but it easily
  869.         caused problems) (Version 3.02)
  870.  
  871. 6 Oct1  This change provides checking for paths in filenames provided during
  872.         WordPerfect exits.  This rename facility is performed at the exit menu.
  873.         Now, if you give a file a name the macro will check the supplied name
  874.         for a path.  If no path is provided in the new name it is given the
  875.         default path.  If a path is provided it is separated from the filename
  876.         (the filename and path are now in separate variables). If the root
  877.         directory is specified, the root directory of the default drive is used
  878.         (this is currently defined by the macro as the root directory of drive
  879.         C).  On blank files, WordPerfect has no method for determining a default
  880.         drive.  However, it will use the default document directory for document
  881.         storage.  Unfortunately, there's no direct way to get to that directory
  882.         specification without first saving a file (without specifying a path
  883.         during the save).  This isn't sufficient for file autoretrieve, however.
  884.         Therefore, the default drive is specifically identified.  New names are
  885.         now correctly identified, along with path names, during a WordPerfect
  886.         exit for inclusion in the retrieve file data file.  Prior to this, the
  887.         user supplied names weren't checked.  If you supplied no name, the file
  888.         was stored on a default drive (whatever it was).  If you supplied a root
  889.         directory, the root drive of whatever drive was used.  However, in this
  890.         case, no drive name was supplied.  This made it difficult to
  891.         autoretrieve some files. (Version 3.10a)
  892.  
  893. 7 Oct1  Fixed a problem with exit ALL option.  Now all files are exited
  894.         correctly.  The only difference between the exit ALL and the EXIT
  895.         WordPerfect options is that the ALL option does not store file
  896.         information on the files exited and leaves the user in WordPerfect,
  897.         document #1. (Version 3.10b)
  898.  
  899. 13 Oct1 If a user was exiting WordPerfect and accepted a file which was modified
  900.         but which had no name ALTF would catch it. However, the filename
  901.         wouldn't get recorded in the autoretrieve information file.  This
  902.         problem was fixed. (Version 3.11)
  903.  
  904. 27 Oct1 Modified the macro to rely on a routine which specifically handles the
  905.         full path specification of a file during a file or WordPerfect exit. 
  906.         The functions which use this operation are exit ALL files or exit
  907.         WordPerfect.  This macro, FN, is called from ALTX through the RENAME
  908.         function.  See FN for a description of the full functionality. (Version
  909.         3.12)
  910.  
  911. 12 Nov1 The macro was modified to rely upon DP (Drives and Paths) to intialize
  912.         the variables used by ALTX.  (Version 3.12a)
  913.  
  914. 17 Nov1 Modified the macro to allow proper operation of a CANCEL while in a file
  915.         rename situation during a WordPerfect exit.  The CANCEL action rewrites
  916.         the EXIT menu after exiting the rename facility.  The file being renamed
  917.         is reset to it's original name and all references to the "new" file name
  918.         removed is from the system. (Version 3.12b)
  919.  
  920. 19 Nov1 Modified the macro to rewrite the screen (and get rid of the Rename File
  921.         instructions) at the conclusion of a file rename at the Exit WordPerfect
  922.         menu (the menu which is displayed when the WordPerfect option is chose
  923.         at the initial EXIT menu).  A test is now made on file names of three
  924.         characters or less.  This test looks for and disallows filenames of the
  925.         following type:  ":", "\", "A:", "A\", or "A:\". Other illegal filenames
  926.         are, for the most part, caught during the exit procedure. It's the
  927.         user's responsibilty to ensure the filenames are correctly specified.
  928.         (Version 3.13)
  929.  
  930. 21 Nov1 In a WordPerfect exit the Rename function wasn't working correctly with
  931.         files which hadn't been named and an ACCEPT option was selected. Now,
  932.         ALTX forces a file rename before the WordPerfect EXIT is performed.
  933.         (Version 3.14)
  934.  
  935. 22 Nov1 After a forced rename, the EXIT menu is returned to so the user has
  936.         another chance at accepting or revising the filenames. (Version 3.14a)
  937.  
  938. 22 Nov1 If both document screens were empty and the EXIT ALL option was chosen
  939.         an EXIT WordPerfect would occur.  No longer...it works as intended
  940.         (stays in WordPerfect). (Version 3.14b)
  941.  
  942. 23 Nov1 The macro tries to insist you name a blank file before a save occurs.
  943.         This happens when either of the document screens is non-blank. (Version
  944.         3.14c)
  945.  
  946. 23 Nov1 Minor change. When exiting WP51 the EXIT options were remaining on the
  947.         screen while saving modified files. Now, those options are removed from
  948.         the screen. (A Purely cosmetic change...) (Version 3.1d)
  949.  
  950. 24 Nov1 Added a routine to prevent exiting WP51 before the autoretrieve
  951.         information get saved. I discovered that if document #1 was blank and
  952.         document #2 wasn't (or vice-versa), the EXIT macro would exit
  953.         WordPerfect without getting a chance to save the autoretrieve
  954.         information. (Version 3.1e)
  955.  
  956. 24 Nov1 Made a minor change to allow checking for an existing file of the same
  957.         name during a WP51 exit. This is important only with a file rename.
  958.         (Version 3.1f)
  959.  
  960. 1 Dec1  Initial version which updates the autoretrieve file. A maximum of four
  961.         filenames are stored in the autoretrieve file.  Files with the same file
  962.         specification have their cursor location information updated. Files with
  963.         the same name but different path are considered "new" and are added to
  964.         the autoretrieve file. New files are added to the bottom of the file and
  965.         removed from the top of the file. The number of files indicator located
  966.         within the AutoRetrieve file is also updated. (Version 4.00)
  967.  
  968. 5 Dec1  Added handling for a file with 0 records and the handling for a non-
  969.         existent autoretrieve file. (Version 4.01)
  970.  
  971. 13 Dec1 Made a change in how an exit from document was performed.  If the file
  972.         had no name and EXIT was chosen from the ALTF submenu (asking the user
  973.         to provide a file name) the document might be exited.  Additionally, it
  974.         the ALTX option chosen was "D" no document switch (from document screen
  975.         1 to document screen 2, for instance) would occur. This was fixed.
  976.         (Version 4.01a)
  977.  
  978. 15 Dec1 A WordPerfect exit message is now displayed during the exit procedure.
  979.         (Version 4.01b)
  980.  
  981. ALT-
  982. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  983.         slower machines. (Version 3.10g)
  984.  
  985. CTRL A (ASCII)
  986. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  987.         slower machines. Removed the message concerning the enter and cancel
  988.         keys. (Version 1.2c)
  989.  
  990. 5 Oct1  Added the ability to save as a generic wordprocessing file (with tabs)
  991.         or as simple ASCII text (no tabs).  Note: indents are converted to tabs
  992.         in the generic save. (Version 1.2d)
  993.  
  994. 23 Nov1 If you want to save your ASCII file with the same name as the original
  995.         document file you may now hit "=" at the filename request line followed
  996.         by the enter key.  The "=" must be the ONLY character entered prior to
  997.         hitting the enter key. This way you avoid alot of needless typing.
  998.         (Version 1.2e)
  999.  
  1000. 26 Nov1 Modified macro to rely on DP for initialization and FN for providing a
  1001.         filename. This simplifies certain things in providing filenames. For
  1002.         instance, the user no longer needs to type the entire name, just modify
  1003.         the existing one. Additionally, if the user wants to use the original
  1004.         file's name for the ASCII file just hit the "=" and hit enter. Simple! 
  1005.         NOTE: a file name is NOT a path name. The character "=" is NOT a valid
  1006.         filename. Don't use it as part of your filename. Made CTRL A a
  1007.         standalone macro called ASCII. Changed the keyboard definition, CTRL-A,
  1008.         to {CHAIN}ASCII~. This procedure transfers control to the ASCII.WPM
  1009.         macro. (Version 2.0)
  1010.  
  1011. 11 Dec1 Minor change. When saving a file to a filename which already exists in
  1012.         the designated path the user is asked if he/she wants to replace the
  1013.         current file. Originally only a Yes or No response was allowed. Now, the
  1014.         user may also use the letter R (for REPLACE). (2.00a)
  1015.  
  1016. 12 Dec1 Made some changes to allow detection of a filename which has a name in
  1017.         memory (but which isn't yet a WordPerfect System name).  This occurs
  1018.         ASCII is called after a file with no name has been given a name but
  1019.         which hasn't yet been saved to disk. The ASCII main menu was modified
  1020.         for additional clarity (less terse).  Added the option SAVE to
  1021.         supplement the ENTER key option. This provides a more visual clue as to
  1022.         what the user must do to save an ASCII file.  The menu now identifies
  1023.         Original and ASCII NAMES instead of FILES.  The menu options line now
  1024.         identifies to what those options refer (the ASCII file rather than the
  1025.         original). (Version 2.01)
  1026.  
  1027. 14 Dec1 Hitting the EXIT key exits ASCII and executes the FILES (ALTF) macro.
  1028.         (Version 2.01a)
  1029.  
  1030. CTRL D
  1031. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  1032.         slower machines. (Version 3.00b)
  1033.  
  1034. CTRL L (Letterhead)
  1035. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  1036.         slower machines. If the macro is run on a non-empty document the cursor
  1037.         is moved to the end of the current document before any letter
  1038.         information (to, subject, from) is entered. (Version 2.7)
  1039.  
  1040. 24 Oct1 Fixed a minor problem which prevented proper operation when chosing a
  1041.         mail stop for the TO: address. (Version 2.7a)
  1042.  
  1043. 26 Oct1 Modified the menu presentation.  Added capability for five line
  1044.         addresses.  Macro now checks to see if the document is empty.  If empty
  1045.         the macro acts normally.  If the document isn't empty the macro puts the
  1046.         cursor at the end of the document and adds a hard page break.  This puts
  1047.         the cursor at the beginning of the new page. (Version 2.71)
  1048.  
  1049. CTRL M (MEMO)
  1050. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  1051.         slower machines. If the macro is run on a non-empty document the cursor
  1052.         is moved to the end of the current document before any memorandum
  1053.         information is entered. (Version 2.7)
  1054.  
  1055. 26 Oct1 Fixed a problem I thought fixed: the macro wouldn't end normally
  1056.         (required the user to hit another key...) (Version 2.71)
  1057.  
  1058. CTRL O  No changes since Sep 91
  1059.  
  1060. CTRL PgDn (RXMEM)
  1061. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  1062.         slower machines. (Version 1.0c)
  1063.  
  1064. 6 Oct1  Changed the variable used to grab memory variables to a less commonly
  1065.         used one.  This is normally not a problem but is in certain situations.
  1066.         (Version 1.0e)
  1067.  
  1068. CTRL S
  1069. 23 Sep1 Modified main menu.  Shortened horizontal line in consideration for
  1070.         slower machines. (Version 1.30a)
  1071.  
  1072. Shift Enh Right Arrow
  1073. 15 Nov1 This macro works by detecting a depressed shift key while the enhanced
  1074.         right arrow is pressed as well. This change detects use while in the TAB
  1075.         edit screen. (Version 2.03b)
  1076.  
  1077. Shift Enh Left Arrow
  1078. 15 Nov1 This macro works by detecting a depressed shift key while the enhanced
  1079.         right arrow is pressed as well. This change detects use while in the TAB
  1080.         edit screen. (Version 2.01b)
  1081.  
  1082. CTRL Enh Left Arrow
  1083. 15 Nov1 This change lets the CTRL Enh left arrow work while in the TAB edit
  1084.         screen. (Version 2.00b)
  1085.  
  1086. CTRL Enh Right Arrow
  1087. 15 Nov1 This change lets the CTRL Enh right arrow work while in the TAB edit
  1088.         screen. (Version 3.01b)
  1089.  
  1090. ALT Enh Left Arrow
  1091. 23 Nov1 This change lets the ALT Enh left arrow work while in the TAB edit
  1092.         screen. This change allows the cursor to move to the previous tab
  1093.         setting. (Version 2.01a)
  1094.  
  1095. ALT Enh Right Arrow
  1096. 23 Nov1 This change lets the ALT Enh right arrow work while in the TAB edit
  1097.         screen. This change allows the cursor to move to the next tab setting.
  1098.         (Version 2.01a)
  1099.  
  1100. CTRL Del
  1101.  
  1102. ALT [   TRANSPOSE LEFT (chains to ALT])
  1103.  
  1104. ALT ]   TRANSPOSE RIGHT/LEFT
  1105.  
  1106. ALTKEY
  1107. 14 Dec1 Added space bar to the options which'll exit the current menu/help
  1108.         screen and re-enter the HELP main menu.
  1109.  
  1110. CTRLKEY
  1111. 14 Dec1 Added space bar to the options which'll exit the current menu/help
  1112.         screen and re-enter the HELP main menu.
  1113.  
  1114. DP
  1115. 10 Nov1 NEW. This macro has NO user functionality.  It is called by either ALTD
  1116.         or ALTF. This is a central macro for all macros requiring basically the
  1117.         same menu structure. At this time that means both ALTD and ALTF.  A
  1118.         change to this menu macro (addition or deletion) is now reflected in
  1119.         both ALTD and ALTF without having to modify both. The user needs to
  1120.         modify ONLY this macro to provide the directories and/or drives
  1121.         necessary for his/her system. Options are now CASE SENSITIVE.  The
  1122.         UPPERCASE only option was removed to increase the number of user
  1123.         definable letter options. (Version 1.0)
  1124.  
  1125. 12 Nov1 Fixed a problem with a misnamed subroutine call which prevented access
  1126.         to drives. Rewrote a routine which didn't seem to work on early model
  1127.         ATs (too long a test...options at the beginning of the test worked,
  1128.         those at the end didn't). Modified a routine to act as a variable
  1129.         intializer for calling macros. (Version 1.0a)
  1130.  
  1131. 13 Nov1 Changed some path information for options to use the default Drive,
  1132.         WordPerfect directory and WordPerfect document variables identified by
  1133.         the initalization routine.  For those options which identify
  1134.         subdirectories off the WP51 directory or document directory (or the
  1135.         "default" drive) this "could" potentially save some work.  (Version
  1136.         1.0b)
  1137.  
  1138. 14 Nov1 Added a TEST to determine whether the initialization routine has been
  1139.         run.  If so, initialization isn't performed again.  Without this test
  1140.         the file Path and Name variables are reset and, if reset, a file rename
  1141.         isn't possible. (Version 1.0c)
  1142.  
  1143. 17 Nov1 Made an explicit test for what macro called this one to correctly set
  1144.         the second menu line (which identifies the current path or path
  1145.         specification). (Version 1.0d)
  1146.  
  1147. 21 Nov1 Made changes to accommodate variables initialization for the EXIT macro
  1148.         (ALTX). (Version 1.0e)
  1149.  
  1150. 24 Nov1 Minor changes to menus were made. (Version 1.0f)
  1151.  
  1152. 26 Nov1 Made changes to accomodate the ASCII option for ALTF. (Version 1.0g)
  1153.  
  1154. 12 Dec1 Made some menu initialization changes for calling macros. (Version 1.0h)
  1155.  
  1156. 13 Dec1 Made a minor change to allow a "re-initialization" of a main menu
  1157.         variable used by ALTF after called by ALTX. (Version 1.0i)
  1158.  
  1159. ENV     No changes since 12 Oct 90
  1160.  
  1161. FN
  1162. 26 Oct1 NEW.  This macro has NO user functionality.  It is called by ALTF and
  1163.         ALTX to manipulate path specifications during file renames. Added to
  1164.         allow a user, during a file rename, decent manipulation of the path
  1165.         specification (i.e. path and filename).  The user is presented with the
  1166.         full path specification during which characters are added, inserted, or
  1167.         replaced. The following functions are provided:
  1168.  
  1169.                 HOME HOME removes the path specification from the cursor to the
  1170.                 beginning
  1171.                 HOME END removes the path specification from the cursor to the
  1172.                 end
  1173.                 HOME RIGHT ARROW moves to the end of the path specification
  1174.                 HOME LEFT ARROW moves to the beginning of the path
  1175.                 specification
  1176.                 DEL removes the character at the cursor
  1177.                 BACKSPACE removes the character before the cursor
  1178.                 INSERT. Added characters shift characters to the right of the
  1179.                 cursor right
  1180.                 = resets to the original path specification
  1181.                 / causes the designated file to NOT be stored (Macro must be
  1182.                 called from ALTX)
  1183.         (Version 1.0)
  1184.  
  1185. 3 Nov1  Added hooks to support ALTF's OTHER option. This option (OTHER) provides
  1186.         a path not provided by the ALTF file save menu. (Version 1.1a)
  1187.  
  1188. 4 Nov1  ALT X menu wasn't being dealt with correctly.  This change fixes it.
  1189.         (Version 1.1b)
  1190.  
  1191. 12 Nov1 Added a variable used by calling macros to detect a CANCEL and therefore
  1192.         act accordingly. (Version 1.1c)
  1193.  
  1194. 19 Nov1 Added a help menu which is displayed when the OTHER option of ALTD,
  1195.         ALTF, or ALTX is requested. (Version 1.3a)
  1196.  
  1197. 23 Nov1 Changed references to arrows in the menu to an actual arrow. Removed any
  1198.         references to enhanced keys. Added a menu description of the INS key.
  1199.         The INS option was always there, just wasn't mentioned in the menu.
  1200.         Added left and right tabs to the menu to go to path separator characters
  1201.         ("/", ":", and "."). Added a border around the menu. (Version 1.4)
  1202.  
  1203. 24 Nov1 Minor changes.  During a file rename from ALTF the message "New Name"
  1204.         instead of "New Path" is displayed.  During an OTHER option from ALTD
  1205.         only the path is displayed instead of the full path specification.
  1206.         (Version 1.40a)
  1207.  
  1208. 26 Nov1 Modified macro to allow use by CTRL A (ASCII). The "=" works differently
  1209.         with the ASCII macro. In this case, it only works at the end of the file
  1210.         name and nowhere else so that the user can override ASCIIs default
  1211.         filename extension used for ASCII (DOS) file names. (Version 1.41)
  1212.  
  1213. 27 Nov1 Made some minor improvements to file specification handling. Home Del
  1214.         would delete the file name but leave the cursor in place (in the middle
  1215.         of nowhere apparently...). This was corrected. Hitting the delete key
  1216.         at the end of the file specification would cause an error which would
  1217.         return to the calling macro. The macro now correctly handles this
  1218.         condition.  Hitting delete on the first character of the file
  1219.         specification wouldn't delete the first character without moving the
  1220.         cursor right and then left again. It now works as it should. (Version
  1221.         1.41a)
  1222.  
  1223. 27 Nov1 Made some minor changes to detect the caller and adjust the menu
  1224.         accordingly. An option available only at the exit WP menu was removed
  1225.         from display unless ALTX calls this macro directly. The END and HOME
  1226.         Left Arrow options were combined in the menu. (Version 1.41b)
  1227.  
  1228. 12 Dec1 Made some minor changes to help menu displays of information (minor
  1229.         tweaks). (Version 1.41c)
  1230.  
  1231. SHFKEY
  1232. 14 Dec1 Added space bar to the options which'll exit the current menu/help
  1233.         screen and re-enter the HELP main menu.
  1234.  
  1235. KNOWN Problem(s).
  1236.   A blocked word at the end of a document may include punctuation. Normally,
  1237. punctuation is not included when a word is blocked (except in blocking multiple
  1238. words).
  1239.